home *** CD-ROM | disk | FTP | other *** search
/ Tools Unlimited 1: The Blanker Collection / Tools Unlimited - Vol 1 - The Blanker Collection.iso / c / RunAnim.doc < prev    next >
Text File  |  1996-02-14  |  5KB  |  133 lines
  1. RunAnim by Stuart "Bonez" MacLean (25/10/95).
  2.  
  3.           e-mail: smaclean@cs.strath.ac.uk
  4.  
  5. Instructions:
  6.  
  7. Disclaimer : The author of this program (Stuart MacLean)
  8. cannot be held liable or responsible for any damage to
  9. both software and hardware that is caused by usage of
  10. this program. 
  11.  
  12. -I hate that bit but you have to cover your backside
  13.  properly in the 1990's-
  14.  
  15. Copyright and Distrubtion : This program is public
  16. domain and hence may not be sold for a propet without
  17. the written consent of the author. Distribute it to
  18. anyone you like on the condition you include this 
  19. documentation with the program.
  20.  
  21. About RunAnim: This is an animation runner for AGA or 68020
  22. processor based machines with two major differences. The
  23. first is the coppermode. The point of this is
  24. that people can watch small size animations on the
  25. full screen. The second was to include a module player so
  26. you can listen to your module while watching the animation.
  27.  
  28. Usage:- CLI>RunAnim <-c> <-r frames_per_second>
  29.             <-w new_width> <-h new_height> iff_anim_filname
  30.             <p61_filename>
  31.  
  32. The options
  33.  
  34. -c : The animation player can run in one of two modes.
  35.      i) The standard anim format in which you see the
  36.      animation playing normally its orginal screen
  37.      mode.
  38.      ii) The lovely hardware hitting copperlist screen
  39.      mode which is the one you requested. The -c option
  40.      will activate this mode otherwise it will play in
  41.      normal mode.
  42.  
  43. N.B. The copper player will only work for colour anims
  44. and not HAM ones.
  45.  
  46. -r frames_per_second : This is simply the option to
  47.      control the frame rate.
  48.  
  49. -w new_width : I realised a problem with programs that
  50.      save their anims of which although they may have
  51.      a small picture e.g. 64*64 but which maybe drawn
  52.      on a larger bitmap e.g. 320*256. So when it comes
  53.      to rescaling it for running in copper mode it will
  54.      scale the 320*256 bitmap instead of the 64*64
  55.      picture. So the solution is for you to tell it the
  56.      width to rescale to for playing in the coppermode.
  57.      Without this the purpose of the coppermode for
  58.      playing small scale animations might have been lost.
  59.      Note this option only works for the coppermode player.
  60.  
  61. N.B. Rescaleing works from the top-left corner of the bitmap.
  62.  
  63. -h new_height : Exactly the same as the -w option but
  64.      deals with the height.
  65.  
  66. The files
  67.  
  68. The first file to type in is the name along with path
  69. directory, e.g. dh1:animations/fish.anim, of the
  70. animation that you wish to view.
  71.  
  72. The second file name is optional and is the name of
  73. a P61 module file. Unfortunately I didn't have any
  74. protracker source code which worked well enough to play
  75. the more complex modules. But as soon as I have a copy
  76. I will compile it into this program and re-realise it.
  77. The P61 Protracker to P61 Player format can be found
  78. in the music appilication draw of aminet.
  79.  
  80.  
  81. The program doesn't have an error detector but if the
  82. animation doesn't load there is either not enough memory,
  83. the name of the file is wrong, or that the animation file
  84. is not of the write format - most likely.
  85.  
  86. History and About the Author:
  87.  
  88. This program was orginially to be a small utility for
  89. my musician (Feekzoid "Big Boss Man") because he wanted
  90. to watch animations and listen to his modules at the
  91. sametime. So I started to write this program. As the program
  92. went on I wanted to make it for everyone to use and also
  93. keep it independent of any software libraries such iff.library
  94. or iffparse.library and allow it to run completely on its
  95. own. So I set about makeing this program with finding all
  96. the depacking IFF ANIM alogrithims and then put it
  97. together and checked it for bugs. Well it took about a month
  98. to complete (I know that is a long time but I have been busy
  99. with starting university again : 2nd year Computer Science
  100. and Mathematics at Strathclyde Univeristy). For those of
  101. you who have seen the Phoenix 2.0 (on aminet:demo/aga/Phoenix.lha
  102. or I have been informed it is on CU Amiga CD for the November 1995
  103. addition) I am still working on the Phoenix 3.0 which is
  104. going to be 1000000% better.
  105.  
  106. Greetings to :
  107.  
  108. Feekzoid (Old Chum and Great Musician).
  109. Shamus (Strange blonde haired person! That is as in Shamanitis).
  110. Krom (He's a strong god! And do you believe in Krom? - Is not
  111.       a recommended chat up line.)
  112. Kris (T-total type story writer.)
  113. Kenz (I look forward to meeting you sir! - Friend of Feekzoid).
  114. John Hendirix (Thanks for the help with Phoenix).
  115. Chris (Keep the texture map site going).
  116. and other people whom I have met and chatted to on the internet.
  117. I really need to get to one of those demo parties.  But I need
  118. a demo - SHAMUS (finish the graphics PLEEEEEEEEAAAAAAASEE!!!)
  119. At this moment I feel like Sandra Bullock's character from her
  120. film The Net but a male version at that. 
  121. ...Greetings to Mother Tereisa, Jona of Arc, Bob, Cutty Sark,
  122. Data, Commander Sinclair (I think B5 is better than Star Trek)
  123. and God.
  124.  
  125. Special acknowledgments to Jarno Paananen of Sahara Surfers for
  126. the creation and use of their P61 player code.
  127.  
  128. I better get to bed I have to be up at 6:00am tomorrow for
  129. Uni.
  130.  
  131. So long and thanks for all the fish!!!
  132.  
  133. Bonez. e-mail at smaclean@cs.strath.ac.uk